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Abstract- General Purpose Input Output (GPIO) is a flexible 
software-controlled digital signal. Micro-processors heavily 
rely on GPIOs with only the BIOS firmware knowing how 
they're used. This paper aims at developing a GPIO library to 
enumerate all GPIOs' configuration status and to create a 
stand-alone user application, which helps a user to configure 
the GPIO pins without diving into BIOS firmware. UEFI 
specifications are followed and EDKII is used. 

Keywords- GPIO, BIOS, UEFI, UEFI-Application, 
Microprocessor, EDKII 

I. Introduction 

The basic input output system (BIOS) also known as boot 
firmware, is built into the PC, and is the first code run by a PC 
when powered on. Industry has migrated from Legacy BIOS to 
a standard and modular pre -boot firmware infrastructure known 
as Extensible Firmware Interface (EFI) [i-iii], EFI BIOS offers 
new & improved features and flexibility for code developers. 

A General Purpose Input Output is an interface available on 
most modern microcontrollers to provide an ease of access to 
the devices internal properties. Generally there are multiple 
GPIO pins on a single microcontroller unit for the use of 
multiple interaction so simultaneous application [iv-v]. Each 
GPIO represents a bit connected to a particular pin. System- 
on-Chip (SOC) processors heavily rely on GPIOs to help with 
pin scarcity on SOCs. Most PC southbridges have a few dozen 
GPIO-capable pins with only the BIOS firmware knowing how 
they're used. 

Now that the IA-32 processors are extended to 64-bit via 
Intel® 64, the industry is working on Unified EFI (UEFI) as 
the standard pre-boot firmware infrastructure going forward 
[vi-vii]. The UEFI specification defines an interface between 
an operating system and platform firmware. The interface 
consists of data tables that contain platform-related information, 
boot service calls, and runtime service calls that are available to 
the operating system and its loader [viii]. These provide a 
standard environment for booting an operating system and 
running pre-boot applications. 

The EFI Development Kit (EDK) is the open-source 
component of the "Framework", Intel's implementation of the 
EFI Specification, which was developed under the project code 
named 'Tiano'. EDK II is a modern, feature -rich, cross- 
platform firmware development environment for the UEFI and 
Platform initialization (PI) specifications. The EDK II offers a 
better build and version tracking environment for UEFI and PI 
development [ix]. 

This paper is organized into five sections including this 
section. Section II presents an overview of related technologies. 
Implementation of the GPIO Library and Application are in 



section III while section IV discusses the results. Finally, future 
improvements and the conclusions are presented in section V. 

II. Related Technology 

A. UEFI Boot Phases 

Different from the implement mechanism of legacy BIOS, 
UEFI BIOS [i-iii] has several phases to make the initialization 
process modularized. In a Framework firmware 
implementation, operating system initialization has four phases 
[i]: Security (SEC) phase, Pre-EFI Initialization (PEI) phase, 
Driver Execution Environment (DXE) phase and Boot Device 
Select (BDS) phase, as shown in Figure. 1. 
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Figure. 1 EFI Boot Phases and services 

The SEC phase is the first phase in the Framework 
architecture and is responsible for handling all platform restart 
events. The PEI phase is handed control from the SEC phase. 
PEI phase is responsible for initializing permanent memory in 
the platform so that the DXE phase can be loaded and executed 
[x]. The DXE phase is where most of the system initialization 
is performed. The DXE foundation produces the full 
complement of EFI Boot Services, EFI Runtime Services, and 
DXE Services. The BDS phase is responsible for implementing 
the platform boot policy, establishing the console devices and 
attempting the boot of operating systems [xi]. 
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B. UEFI-BIOS Code Structure 

UEFI-BIOS code is modular and is divided into different 
packages. Each EDK II Package is a container that includes a 
set of modules and their related definitions. Each Package is an 
EDK II distribution unit. It can be used to manage and release 
the big project to facilitate a user's distribution and reuse. The 
whole project sources can be split into different packages to 
reduce the release granularity [xii]. Some of the packages and 
their definitions are listed in Table 1 . 



TABLE I 
Packages In UEFI-BIOS 



Package 


Description 


Basetool 


Provides build related tools for both 
EDK and EDK2. Also contains 
miscellaneous tools such as ECC, 
EOT 


PlatformPkg 


Provides the Platform specific code. 


RefcodePkg 


Provides Silicon specific reference 
code. 


CryptoPkg 


Several security features like 
Authenticated Variable Service, 
Driver Signing, etc., are introduced 
here. 


EdkCompatibilityPkg 


Provides header files and libraries 
that help to build the EDK module in 
UEFI 2.0 mode with EDK II Build. 


FrameworkPkg 


This package provides definitions and 
libraries that comply to Intel's UEFI 
& EFI Framework Specifications. 


MdePkg 


Provides all definitions (including 
functions, macros, structures and 
library classes) and libraries 
instances, which are defined in MDE 
Specification. 


NetworkPkg 


Provides IPv6 network stack drivers, 
IPsec driver, PXE driver, iSCSI 
driver and necessary shell 
applications for network 
conifguration. 


ShellPkg 


This package provides native EDKII 
implementation of a UEFI Shell 2.0. 


UefiCpuPkg 


This Package provides UEFI 
compatible CPU modules and 
libraries. 



GpioLib.c file : It is a source file written in C language. It 
consists of the source code to perform different functions. 
GpioLib.h file : It is a header file which supports the source file. 
It includes constant definitions and library files that are used by 
the source file. This header file is included in the source file. 
GpioLib.inf Tile : It is a text file with .inf extension. It is called 
the information file. It follows the standard EDK II INF file 
format. This file is used by the build tool to understand the 
information about the library. 

The source file GpioLib.c and the information file 
GpioLib.inf are placed in the Library section of the Platform 
package mentioned in Table 1. The header file GpioLib.h is 
placed under the Include section of the Platform package. 

D. UEFI Shell 

The UEFI Shell [xiii] is a simple, interactive pre-boot 
environment that allows UEFI device drivers to be loaded, 
UEFI applications to be launched, and operating systems to be 
booted. In addition, UEFI Shell also provides a set of basic 
commands used to manage files and the system environment 
variables etc. Figure. 2 depicts the UEFI Shell interface. 
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Each package has a unified directory structure that separate 
the different source files. The root directories in each package 
are: Include, Library, Application and Drivers. The Include 
directory contains all public header files exposed by this 
package and used by this package and other packages. The 
Library directory contains directories for each library instance 
module included. The Application directory contains 
directories for each UEFI applications module included. The 
Driver directory contains directories for each driver group and 
for each driver. 

C. GPIO Library 

GPIO Library which is developed in this paper is composed 
of the following files: 



Figure. 2 UEFI Shell interface 

E. UEFI Application 

UEFI application [xiii] is a stand-alone entity which can be 
launched from UEFI shell. It can be used to perform a specific 
task when the application is called and exit upon completing 
the task. In our case, a UEFI application is developed to get the 
GPIO information, and configure a GPIO pin. 

The application also consists of three files. GpioApp.c 
source file, GpioApp.h header file and GpioApp.inf information 
file. These files are placed in the Applications section of the 
Platform package. After the BIOS source code is built, a '.efi' 



IJSET@2014 



Page 525 




IJSET 



file is generated, in this case, GpioApp. efi. This is the stand- 
alone application file which can be launched in UEFI shell. 

III. Implementation of GPIO Library and 
Application 

A. GPIO Library Functionalities 

The GPIO Library majorly has two functions. 
First: To read the GPIO configuration registers and 
interpret the status of every GPIO - There are various registers 
in particular to every GPIO pin. The library is capable of 
identifying those registers from memory, reading them and 
interpreting their values in form of verbal message strings. A 
function module Tablef) reads all the GPIO configuration 
registers in order, and gives out the information of all GPIO 
pins in lists of strings. Another function PinlnfoQ takes a 
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particular GPIO pin number as input and reads only that 
particular pin related configuration register, and gives out the 
information of only that pin. 

Second: To change the configuration status of a GPIO pin- 
In contrast to the first functionality, here the Library can take 
different GPIO attributes as input, and write to the GPIO 
registers. A function GpioWritef) takes the GPIO pin number, 
and various pin attributes as inputs, it decides what bits need to 
be written to, what values to be written, and selects the 
appropriate GPIO configuration register to write the selected 
values in selected bit positions. The remaining bit values are 
unaltered by suitable masking, so that the remaining attributes' 
configuration is kept as before. This is done so that, only the 
attributes selected by the user are altered and remaining are not 
touched. 

The implementation flowchart of the GPIO Library is 
shown in Figure. 3. 
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Figure. 3 Implementation Flowchart of the GPIO Library 



B. UEFI Application Functionalities 

The UEFI Application is launched in the UEFI Shell 
Interface by typing the Application name GpioApp as the first 
argument. It has various functionalities. 

First: Usagef) - The user must know how to use the 
Application, what all tasks can be performed by it, what inputs 
can be given. This is done by the Usagef) function. When the 
Application is launched with only one argument, which is its 
name GpioApp, Usage() displays the information about the 
capable tasks of, and valid inputs to the Application. 

Second: To read GPIO Table - When Application is 
launched with two arguments <GpioApp> <table>, the 
application calls the Tablef) of the GPIO Library. A list of 



strings given out by the library is formatted and displayed in 
the form of a table. 

Third: To read a selected GPIO pin 's information - 
Application when launched with three arguments <GpioApp> 
<GpioPin#> <read> it calls Pinlnfof) of GPIO Library and 
formats the output string into a legible display. 

Fourth: To configure a selected GPIO pin - A GPIO pin 
has many electrical attributes like pullups, current source, open 
drain mode, etc., and software attributes like interrupt, wake, 
high impedance etc., these attributes can be selectively 
configured by giving <GpioApp> <GpioPin#> <configure> 
<attributel> <attribute2> . . . <attribute-n> 
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Fifth: To display suitable error messages for Invalid inputs The implementation flowchart of the GPIO Application is 
- The Application discards invalid or inappropriate user inputs shown in Figure.4. 
and displays suitable error messages. 
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Figure.4 Implementation Flowchart of the UEFI Shell Application 



IV. Results and Discussion 

Currently, only BIOS firmware can configure GPIOs and a 
library such as the GPIO library does not exist. Any non-BIOS 
engineer who wants to configure a GPIO pin must invariably 
depend on a BIOS engineer to get the required configuration. 
This consumes lot of time for both of them and work gets 
slower. Also debugging and validating the configuration status 
of all GPIO pins is very time consuming and confusing at times. 
These issues are the concern of this paper where in, the 
developed GPIO library gives out all configuration details of 
GPIO pins in form of a table, which can be just handy at times 
of validating and debugging. There is also an option of reading 
a selected pin's information using this library. The two ways of 
display is incorporated to enable flexibility of the library to use 
it as desired by individual users. Also, to solve the problem of 
non-BIOS engineers, the library is also made capable of 
configuring the GPIO pins. To ensure that these functionalities 
are used by all users in an easier and BIOS independent fashion, 
a UEFI Shell Application is developed which uses the GPIO 
Library and performs the desired tasks in a user-friendly 
fashion. 



The display for individual GPIO pin is shown in Figure. 5 
and the GPIO table display in Figure. 6. 
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Figure. 5 Information of a selected GPIO pin 
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i$$$t GPIO Pad configuration Information Table $$$$$ 
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Figure. 6 GPIO Information Table 



V. Conclusion 

GPIO or General Purpose Input Output is the easiest way to 
interact with basic peripheral components. Non-BIOS 
engineers find difficulty in configuring GPIOs and have to rely 
upon BIOS engineers. As a solution to this problem, this paper 
proposes a GPIO Library capable of enumerating all GPIOs' 
configuration status and also to configure a pin with desired 
attributes. A UEFI shell application is developed to perform 
these tasks in a user friendly fashion. It also comes in handy at 
times of debugging and validation. As a future scope, the 
application can be made more interactive for users and also can 
be extended to develop runtime applications. 
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